Skip to content

模型调用 / API 密钥 ​

「API 密钥」管理当前登录用户自己的调用凭证,用于在程序或工具中调用大模型服务。页面可以创建密钥、复制密钥、查看额度与剩余额度,并核对状态和到期时间。

前提条件 ​

  • 已登录 Console 用户侧,并具备「AI 模型服务」的访问权限。
  • 已选择目标工作空间,示例为当前工作空间。
  • 需要调用的模型已在「模型列表」中可见。

界面说明 ​

API 密钥

截图采集于 2026-11-02,环境:主环境。

页面左上角为「模型调用 / API 密钥」,说明文字为「管理我的API密钥,可调用大模型服务,支持查看额度、复制密钥并设置到期时间。」。

工具栏从左到右依次为:搜索维度下拉「选择搜索维度」、「额度」筛选、「状态」筛选;右侧为蓝色「创建」按钮、「列显隐」和「刷新」。

表格字段如下:

字段说明
名称密钥名称,下方灰字显示归属与密钥尾号,例如「admin/eb826dbe」,尾号后的图标可复制。
状态密钥当前状态,截图中出现「已启用」「已禁用」「管理员已禁用」。
API Key脱敏后的密钥值,例如「sk-******eb826dbe」,行内图标可复制。
额度额度类型,截图中为「不限」或「暂不可用」。
剩余/总额剩余额度与总额度,截图中为「不限」或「额度暂不可用」。
描述密钥的用途说明。
创建时间密钥创建时间。
到期时间密钥到期时间。
额度更新时间最近一次额度调整时间。
操作「额度明细」和「更多操作」。

截图中当前视图显示「名称」「状态」「API Key」「额度」「剩余/总额」「操作」,其余列可通过「列显隐」打开。列表底部显示总数,截图中为「共 1039 条」,右侧为每页条数与翻页控件。

单击「创建」后,页面右侧滑出「创建 API 密钥」抽屉,标题下的说明为「密钥归属当前登录用户所有。」。抽屉中只有两个字段:

字段说明
API 密钥名称*密钥名称,带星号表示必填。
描述密钥用途说明,多行文本。

抽屉底部为「取消」和蓝色的「创建」按钮。

操作步骤 ​

创建密钥 ​

  1. 在左侧导航选择「模型调用」>「API 密钥」。
  2. 单击工具栏右侧的「创建」。
  3. 在「创建 API 密钥」抽屉中填写「API 密钥名称*」和「描述」。
  4. 单击抽屉底部的「创建」。

复制密钥 ​

  1. 在目标行找到「API Key」列。
  2. 单击脱敏值后的复制图标,将密钥复制到剪贴板。
  3. 需要复制密钥名称或归属信息时,单击「名称」列灰字后的复制图标。

查看额度 ​

  1. 在目标行单击「额度明细」,查看该密钥的额度记录。
  2. 需要其他维护操作时,单击该行的「更多操作」。
  3. 用工具栏的「额度」「状态」筛选缩小列表范围。

调用模型 ​

调用地址和模型名称以「模型列表」中模型详情页提供的信息为准。下面是最小示例,替换尖括号中的内容后使用。

bash
curl "<模型调用地址>" \
  -H "Authorization: Bearer <API Key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<模型名称>",
    "messages": [{"role": "user", "content": "你好"}]
  }'

使用 OpenAI SDK 时,把 base_url 指向模型详情页提供的地址,api_key 填完整密钥。

python
from openai import OpenAI

client = OpenAI(
    base_url="<模型调用地址>",
    api_key="<API Key>",
)

resp = client.chat.completions.create(
    model="<模型名称>",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

结果验证 ​

  • 创建后列表中出现新记录,名称与抽屉中填写的内容一致。
  • 复制后粘贴到调用脚本中,密钥前缀为「sk-」。
  • 单击「额度明细」后能看到该密钥的额度变化记录。
  • 状态筛选为「已禁用」时,列表只剩被禁用的密钥。

注意事项 ​

  • 密钥归属当前登录用户,其他成员看不到、也不能使用你的密钥。
  • 状态为「已禁用」或「管理员已禁用」的密钥不能用于调用;后者需要管理员处理。
  • 「额度」显示「暂不可用」时,「剩余/总额」列同步显示「额度暂不可用」,此时无法判断剩余量。
  • 密钥等同于账号凭证,不要写入公开代码仓库、前端代码或截图。
  • 「更多操作」中的删除类操作不可恢复,执行前确认没有业务仍在使用该密钥。

相关操作 ​